home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 10 / AACD 10.iso / AACD / Utilities / PalmLink / PALMLINK-SOURCE.readme < prev    next >
Text File  |  2000-05-06  |  3KB  |  97 lines
  1.  
  2.  
  3.  INTRODUCTION
  4. -------------- -- -
  5.  
  6. PalmLink bases on the PilotLink software by Kenneth Albanowski. Anyhow,
  7. it is not just a Un*x port, but has been written from the scratch new.
  8.  
  9. PilotLink is very memory consuming. Each layer allocates a new buffer,
  10. adds the layer headers and trailers to this buffer and then copies the
  11. data from the previous layer to the new layer.
  12.  
  13. PalmLink has only one buffer for the data and all the headers. It does
  14. not require to copy the data all the time, thus it is faster and less
  15. memory consuming.
  16.  
  17. I don't have the time to improve PalmLink any further. So I decided to
  18. make its source code public.
  19.  
  20. What you have here is the latest and unreleased version of PalmLink.
  21. I have translated all in line comments to English. Anyhow the function
  22. headers of all library functions are still commented in German. You
  23. should read the AutoDocs to get their meanings.
  24.  
  25.  
  26.  
  27.  REQUIREMENTS
  28. -------------- -- -
  29.  
  30. You will need the latest SAS/C, PhxAss and PhxLnk package to compile
  31. PalmLink. I don't know if other compilers, assemblers and linkers can
  32. be used as well. The assembler part only provides a library skeleton;
  33. maybe you can even port it to C, so you won't need an assembler at all.
  34.  
  35. Unfortunately, SAS/C is not produced any more, but you might get it
  36. second hand or try another compiler. PhxAss and PhxLnk is a FreeWare
  37. assembler and linker made by Frank Wille. You will find it in the
  38. AmiNet.
  39.  
  40. In order to understand the source code, you should know about packet
  41. layer techniques. I also suggest to have a look at the PilotLink source
  42. from Kenneth Albanowski. You should find it on most Linux distributions
  43. and in the internet.
  44.  
  45. For compilation of the Assembler file, you should put the lvo/exec.i
  46. file into your INCLUDE: path. In all those years I programmed for the
  47. Amiga, I have developed my own way to call library functions. :-)
  48.  
  49. If you use an editor which supports text folding (as e.g. GoldEd),
  50. configure it to use '//>' and '//<' as fold markers.
  51.  
  52.  
  53.  
  54.  GNU
  55. ----- -- -
  56.  
  57. The GNU General Public License will apply.
  58.  
  59.   PalmLink - Connecting Amiga to the 3Com Palm
  60.   Copyright (C) 1998-2000 Richard Körber
  61.  
  62.   This program is free software; you can redistribute it and/or modify
  63.   it under the terms of the GNU General Public License as published by
  64.   the Free Software Foundation; either version 2 of the License, or
  65.   (at your option) any later version.
  66.  
  67.   This program is distributed in the hope that it will be useful,
  68.   but WITHOUT ANY WARRANTY; without even the implied warranty of
  69.   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  70.   GNU General Public License for more details.
  71.  
  72.   You should have received a copy of the GNU General Public License
  73.   along with this program; if not, write to the Free Software
  74.   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  75.  
  76. For further details, see the COPYING file of this package.
  77.  
  78.  
  79.  ADDRESS
  80. --------- -- -
  81.  
  82. If you want to contact me, you can reach me at one of these addresses:
  83.  
  84.   shred@shredzone.de
  85.   rkoerber@gmx.de
  86.   shred@web.de
  87.  
  88. Please don't contact me if you want me to put some improvements to the
  89. source code. Also, don't ask me newbie questions. I am quite busy and
  90. don't have the time to answer to minor problems and RTFM stuff. :)
  91.  
  92. Also, visit my home page at:
  93.  
  94.   http://www.shredzone.de
  95.  
  96.  
  97.